BBS Toolkit

home *** CD-ROM | disk | FTP | other *** search

/ BBS Toolkit / BBS Toolkit.iso / qbbs / cbs_121q.zip / CBS_Q.DOC next >

Wrap

Text File | 1990-05-17 | 31KB | 1,074 lines

COMPUTER SOFTWARE ASSOCIATION CALL BACK SYSTEM Version 1.20 Written by Patrick Stierman Sysop: Micro Hub BBS (602) 649-9412 Documentation by: Patrick Stierman and John Bierrie Copyright (C) 1990, Computer Software Association Copyrighted @ Feb,1990 ALL RIGHTS RESERVED CONTENTS -------- I. Introduction................................. i Copyright Notice............................. ii Shareware License............................ ii Shareware Registration....................... iii Warranty and Limit .......................... iii II. Installation................................. 1 CBSinst.Exe................................ 3 Local.Ctl.................................. 6 III. Appendix A Sample Batch Files......................... 8 IV. Appendix B Sample Menu & Registration Questionnaire... 11 V. Appendix C Support Systems............................ 12 VI. Registration................................. 13 VI. Notes........................................ 14 INTRODUCTION ************ This program was written to serve the needs of all high speed modem users. While trying to get several of the common Call back verifiers up and on-line with my BBS I came to the conclusion that these programs were written for the low speed modem users. Higher speeds and Locked port support was added as an afterthought. These programs were often well written but the programmer had no way to test out the code. Thus along came the 'well it works for me it should work for you syndrome. After several months of fighting these problems I decided to write a Call Back Verifier program that WORKS with the HST modems and others that use Locked Baud rates to the fossil. Thus along came this Program. I wrote this program to support my BBS only, when someone else heard I had one that worked. Thus a shareware version came to be. I had only supported locked baud rates in the original program and had to allow for floating connect rates. The program was rewritten to include these support functions. Then came the realization that not everyone had 100% Hayes compatible modems. Oh well, back to the drawing board and out comes the config.dat file. Trying to keep required files at a minimum I had to add only one more file to define local calls for those who don't want to call all over the USA on their dime. Local.ctl fills that requirement. Thus to run this program, there are only three files required instead of the 6 or more for most other verifiers. As with all programs there will be upgrades and revisions as the users request or demand options I didn't think of. The latest version of this software will always be available for D/L on the support BBS's Fido addresses 322/235 and 114/70. The boards are HST and up 24 hours except during ZMH. Stop by and also check out some of the other fine software available on these BBS's. The newest release of CBS will always be available for D/L on these BBS's. You may also FREQ CBS on 322/235 or 114/70 as CBS_Q and get the latest release that way. i COPYRIGHT Notice ****************** No part of this manual may be reproduced, transmitted or translated into any language, in any form or by any means, except as described in the following license with out the prior written permission of Patrick Stierman. You are granted a limited license to use this software described in this manual. The software may be used or copied only in accordance with the terms of the license agreement within this manual. SOFTWARE LICENSE ================ This software is provided to run on one machine and one machine only. It is non-transferable. You may use this software on a limited basis for a trial period (30)days. After this evaluation you must either register it or cease to use said software. You may make copies of this software to be distributed only in the original format and package. You may NOT delete any files from the initial distribution package. The archived file must remain intact. You may NOT charge any fee for this service to distribute. You may upload the distribution archive to any bbs you desire as long as the software has not been modified. CBS's Call Back System must not be released or included in any other software package with out a written agreement from "CSA", Computer Software Association. Operators of BBS systems or electronic mass media systems may post the original unmodified archived package for download by their users without written permission as long as no fee is charged for the downloading of the file. Access fees may be charged but no fee must be charged for the specific downloading of CBS. ii SHAREWARE Registration ********************** Computer Software Association's Call Call Back System is not PUBLIC DOMAIN software. It is SHAREWARE. If you use it for more than the trial period (ie 30 days), You must pay and register it. The registration fee is a mere $12.95 (non commercial), $50.00 (commercial). Registration entitles you to bug fixes, notification of NEW RELEASES and registered versions of the new releases until otherwise stated by CSA. The registration form is located at the end of this manual. Please fill it out completely to allow us to contact you should the need arise. That is to forward any bug fixes that HOPEFULLY will never be required. MAIN SUPPORT BBS's: Micro Hub BBS Doc's Place BBS Fido 1:114/70 Fido 1:322/235 (602) 649-9412 (508) 520-4564 Registration information Please make all checks or money orders payable to: CSA Send to: CSA C/O John Bierrie 658 Old West Central St. Franklin, Ma 02038 There are no warranties associated with this software, either expressed or implied. The user of this program assumes all responsibility for operation of this program and any damages resulting from its use. The "commercial" registration entitles you to other services not mentioned in this document. For further information, contact John Bierrie directly. WARRANTY and LIMITS ******************* This software is provided AS IS without any expressed or implied warranties whatsoever. No warranty of fitness for a particular purpose is offered. The author of this software cannot be held responsible for DIRECT, INDIRECT INCIDENTAL, CONSEQUENTIAL, or ANY OTHER damages due to your ability or inability to use this software, even if the author has been advised of the possibility of such damages. The user assumes full responsibility for the use of this software. iii FILES INCLUDED IN THIS PACKAGE ------------------------------ CBS.EXE <------ Actual CBS program CBSINST.EXE <------ CBS installation program CONFIG.DAT <------ Sample Configuration file CBS_Q.DOC <------ These Documents CBS.MNU <------ Sample Menu REGISTER.Q-A <------ Sample Registration Questionnaire to work with CBS menu REGISTER.ASC <------ Sample explanation file for CBS READ.ME <------ Last minute changes, information, etc. SYSTEM REQUIREMENTS ------------------- Quickbbs 2.6? or greater MS-DOS 2.1 or later HAYES compatible modem INSTALLATION ------------ Welcome to CSA's Call Back System. With this program, Sysops' have the ability to upgrade new user access automatically. This version supports Quickbbs 2.6? versions and above unless they do some drastic changes in the code with future releases. There are two support files required with this program and are supplied in the distribution package. There are also three sample files, one Menu and one Questionnaire and an Information file. Their usage is described separately later on in the documentation. ***********CBS MUST BE RUN AS A TYPE 15 EXIT!!*************** CBS will support all valid baud rates and if you have your com port locked it will support that too. SWITCHES -------- /L LOCKED PORT This command line switch tells CBS the modem and com port are locked to the following speed. CBS /L=19200 or /L=38400 1 /C CALL BACK SYSTEM Directs CBS to act as a "Call Back System" and not upgrade the user's Security Level or Flags. CBS /L=19200 /C /F=\Logs\CBSCBACK.LOG /F LOG FILE You may specify a separate log file for CBS, or default to the Quickbbs "System.log" : CBS /F=CBS.Log for CBS's own log /F= Supports Full Drive and Path format NO command line switch /F will result in default to the Quickbbs System.Log /T TEST MODE To test CBS in LOCAL mode. CBS /T CBS also *** MUST *** have the modem configured to disconnect users by dropping DTR. In the next version we will add support to disconnect users with modem control strings. 2 CBSINST.EXE ----------- ********************** FIRST OF ALL!!!! ********************* If you were running a previous version of CBS, (before 1.10) delete the OLD Config.Dat file before running CBSINST !!! -------------------------------------------------------------- Run CBSINST to setup CBS. It will create a file called Config.dat. This is where the program gets its information on what it does with each user. It has provisions for setting the new security level and for changing all of the user's flags. These changes take effect immediately after verification of password and re-entry into Quickbbs. Use keys F2 to exit and F1 to Save/Exit the CBSINST program. New User Is the level each new user has prior to verification and is a number from 1 to 32000. It must not be a 0 as zero is what Quickbbs uses to lock out a user hence, someone with this level would never have access to this program. Member Is the NEW security level you wish a verified user to have. It also must be an integer between 1 and 32000. 3 SECURITY FLAGS The next four entries are for upgrading the user's Flags when they have been verified. Each set of flags can have 2 states, [on] or [off]. By using one of the 4 options for each flag, you have complete control over what CBS does to the flags. (You must put one in each flag slot!!) The options are: <*> Tells CBS to ignore this flag. Whatever state the flag was in remains after verification. <X> Force this flag ON. No matter what the flag was. It will be forced on. <-> Force this flag off. Again as above no matter the original state this flag will be forced off. <?> This toggles the flag. If it was originally ON it is changed to OFF. Likewise if it was originally OFF it will be changed to ON. MODEM INITIALIZATION In this release, it is NOT mandatory to set your initialization string. This should be set however, to speed in upgrading to newer versions of CBS, as later releases will implement this. MODEM DIAL PREFIX These are the codes sent to the modem prior to dialing a number. Normally ATDT for Hayes compatible modems. This can also be used for entering in any special dialing commands you might need, such as a "9" for outside lines and the like. ATDT~9~~ MODEM DIAL SUFFIX Is the command set to the modem after the dial string is sent. Normally a | or <cr>. This instructs the modem to begin dialing the number. MODEM OFF HOOK COMMAND The is the command the modem needs to go OFF HOOK, that is, to pick up the phone. It is usually ATH1| 4 MODEM ON HOOK COMMAND This is the command to tell the modem to HANG UP the phone, or go "on hook". It is usually ATH0| DEFAULT AREACODE Area code CBS will use if user neglects to enter one when initially logging on. SYSOP NAME Your name. Use only a space between first and last name. RESUMEBBS Is a Y or N entry telling CBS to either log off after verification or Resume BBS operation. A <Y> will allow the user back into the calling menu in Quickbbs. LocalResume To allow the system to call back "local" users as defined in the Local.ctl file. LD Resume To allow the system to call back "Long Distance" numbers. Any phone number entered as long distance in the Local.ctl file. LOCAL COLOR This Flag will toggle Local Color on and off only on the local display. Color will still be display to the user if his graphics flag is on. DUP CHECK This is either a Y or a N telling CBS to check for duplicate phone entries. CHECK LEVEL If you specify Y in the previous entry Dup Check, then you will need to set the level of checking. Level 1 or 2 is to be set as follows: Level 1 Send only a report to your system log. It will log the name of the current user as well as the name of the user that also has that same phone number. Level 2 Check for duplicate numbers, then LOCKOUT that user record IF the phone number duplicates another users. 5 LOCAL.CTL ********* LOCAL.CTL is the file that tells CBS which numbers are local calls. You can now tell CBS to call any number anywhere. But you will still have full control on what numbers will be allowed. We did this to allow users in large towns or densely populated areas that have many local or low cost dial zones. CBS now looks at the local.ctl file a little differently than before. There are now several control characters that CBS uses to control the dialing of the modem. Shown in the sample below are the flags and how they work. All new area codes must be precede with one of the 4 flags allowed. Else CBS will not be able to tell the difference between a new area code or just additional prefixes for the last area code. The flags are described below. SAMPLE LOCAL.CTL +602 @602 213 123 456 234 789 #789 790 791 !792 145 235 236 etc.... >>>NOTICE<<< each prefix is on it's own line with nothing following. The file must follow this layout exactly or else the program will fail to find matches and all numbers would appear as Long Distance calls and CBS won't call them. Description of AreaCode Flags: (+) Is the first entry and tells CBS the actual AREA CODE which is local. ie Put your area code here. (@) Tells CBS that all prefixes that follow are local calls and are ok to call. CBS will call the number as a 7 (seven) digit number. ie (999-9999). 6 (#) Tells CBS that there is a new area code or that the dialing conditions have changed. The # flag denotes that the next set of prefixes require a 1 in front of the number to dial that number. The prefixes that follow are also OK to dial. ($) Tells CBS that there is a new area code or that the dialing conditions have changed. The $ flag denotes that all prefixes that follow are OK to dial and require 1+area code+ number to dial. CBS Will still NOT call any prefix or number unless it is included in the local.ctl file. It works that way to give the sysop total control over who CBS calls. That way CBS can't call Long Distance unless YOU tell it to. Area codes can be duplicated under different flags as it is quite possible to have local calls to certain prefixes and also Long distance calls in the same city to different prefixes. Example Local.ctl : +602 @602 464 #602 986 1. 602-464-1270 and 2. 602-986-1111 Phone number one is local to my area and phone number two is long distance. Number 2 requires a 1 in front of the number to dial where as number 1 does not. These would go into the Local.ctl files like this. This tells CBS to call 464 as local and 986 as 1+number. As long as the prefixes are in Local.ctl then they are valid numbers to call. If you exclude any prefixes in the area then CBS won't be able to call that number as it can't find them in the Local.ctl file. This is a way to eliminate certain areas from being able to be called. (why someone would so this I really can't tell, But it is there just in case) Numbers such as 911 cannot be dialed as no one would actually have 911 as a prefix to their number. Thus 911 calls are filtered out totally. Neat huh.... If 911 is not in the Local.ctl file then CBS won't dial it..... 7 APPENDIX A... SAMPLE BATCH FILES The following is an extraction from my Mailer.bat file that runs Micro Hub BBS. CBS works here with this setup quite well. I am sure there are other ways of doing this but this works for me. STAND-ALONE Quickbbs BATCH FILE ------------------------------- :After_Quickbbs If Errorlevel 61 goto start If Errorlevel 60 goto Leech If Errorlevel 51 goto Start If Errorlevel 50 goto CBS If Errorlevel 41 goto Start If Errorlevel 40 goto Bimodem If Errorlevel 11 goto Start If Errorlevel 10 goto Outside If Errorlevel 5 goto Net_Echo If Errorlevel 4 goto Echo_Only If Errorlevel 3 goto Net_Only goto Start ... :CBS CBS /l=19200 goto Restart_Quickbbs :RESTART_Quickbbs cd\qbbs Quickbbs -r -e0 goto After_Quickbbs ... :out Echo MicroHub BBS ......GOING.....GOING.....GONE 8 Quickbbs WITH MAILER SAMPLE BATCH FILES --------------------------------------- Sample batch file to work with Front Door, DBridge, etc... @ECHO OFF :start c: cd\fd fd if ERRORLEVEL 200 goto unpackmail if ERRORLEVEL 196 goto 9600_Baud if ERRORLEVEL 124 goto 2400_Baud if ERRORLEVEL 112 goto 1200_Baud If ERRORLEVEL 36 goto local if ERRORLEVEL 1 goto out if ERRORLEVEL 0 goto start goto start :9600_Baud cd\fd\Quickbbs Quickbbs -b2400 -E0 -P if ERRORLEVEL 30 goto CBS if ERRORLEVEL 14 goto CBSCBACK goto After_Quickbbs :2400_Baud cd\fd\Quickbbs Quickbbs -b2400 -E0 -P if ERRORLEVEL 30 goto CBS if ERRORLEVEL 14 goto CBSCBACK goto After_Quickbbs :1200_Baud cd\fd\Quickbbs Quickbbs -b1200 -E0 -P if ERRORLEVEL 30 goto CBSCBACK if ERRORLEVEL 14 goto CBS goto After_Quickbbs :After_Quickbbs if ERRORLEVEL 9 goto start if ERRORLEVEL 6 goto Maintain if ERRORLEVEL 5 goto Net&echo if ERRORLEVEL 4 goto Echo if ERRORLEVEL 3 goto Net if ERRORLEVEL 0 goto start goto start :CBSCBACK CBS /L=19200 /C /F=C:\logs\callback.log goto Restart_Quickbbs :CBS CBS /L=19200 /F=C:\LOGS\CBS.LOG goto Restart_Quickbbs 9 :Outside CTTY COM2: WATCHCD COM2: ON <PROGRAM NAME> WATCHCD COM2: OFF CTTY CON: goto Restart_Quickbbs :Restart_Quickbbs Quickbbs -R -E0 -P if ERRORLEVEL 30 goto CBSCBACK if ERRORLEVEL 14 goto CBS goto After_Quickbbs :out 10 APPENDIX B... SAMPLE MENU & REGISTRATION QUESTIONNAIRE FILES --------------------------------------------- Included with the CBS System package are four additional files to help you make a "Clean and Neat" installation of the CBS program. You are welcome to use them, modify them or just plain throw them out... CBS.MNU Call this menu up from your "TOP" menu using whatever command you are comfortable with. I use "R". This menu will allow the user to read about the "whys and hows" of the CBS system, answer a Registration Questionnaire and then use the CBS program itself. NOTE: If you use this menu, please remember to "Edit" line # 10 of the menu to reflect your name. REGISTER.Q-A Sample Registration.Q-A used by this system. REGISTER.ASC Sample "Information" file accessed by the CBS.MNU explaining a little about who needs to use the CBS, why it is used and what to expect while using it. 11 APPENDIX C... SUPPORT SYSTEMS --------------- The following boards act as "Support Systems" for CBS and related products. Each system carries the latest release of CBS requestable with the Magic name of "CBS_R". Each system is also tied together via NetMail to insure the fastest responses to any questions or concerns. WESTERN REGION EASTERN REGION -------------- -------------- 1:114/70 1:322/235 Micro Hub Doc's Place BBS Mesa, Az. 85201 Franklin, Ma. 02038 602-649-9412 508-520-4574 Sysop - Patrick Stierman Sysop - John Bierrie 12 Registration FORM ================= Use your name and BBS name "exactly" as they appear on your system!! * Sysop's Name...........___________________________________ * BBS Name...............___________________________________ * BBS Phone Number.......___________________________________ * FidoNet Number.........___________________________________ (if applicable) * Address................___________________________________ ___________________________________ ___________________________________ * Company Name...........___________________________________ (if applicable) Costs: Call Back System - Single copy: $12.95 (non-commercial) - Single copy: $50.00 (commercial) - Multiple copy: Write for more information. Please make all checks or money orders payable to: CBS Send to: CBS C/O John Bierrie 658 Old West Central St. Franklin, Ma 02038 Registration entitles you to new releases as they become available. Registration will also entitle you to telephone support. No number will be given until you have registered. Any questions until registered, will be handled via snail mail or FIDO mail address 322/235 114/70 or by logging on to one of the support BBS,s: Micro Hub BBS Doc's Place (602) 649-9412 (508) 520-4574 HST 23 Hours HST 23 Hours 1:114/70 1:322/235 Thank You For Supporting Shareware Software................ 13 NOTES -----